home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / Q / QuickB DL 1.20.cpt / About QuickB Download 1.20 next >
Text File  |  1988-06-16  |  8KB  |  183 lines
  1.                                QuickB Download
  2.                                ------ --------
  3.  
  4.                            v.1.20 of June 16, 1988.
  5.           QuickB Download Desk Accessory was written by Raymond Lau.
  6.                          Copyright 1988, Raymond Lau.
  7.  
  8.     QuickB Download is shareware. Try it a few times. If you like it, find
  9.    it useful, or save some money off your CompuServe bills, please register
  10.                        it by sending $15 to the author:
  11.  
  12.                                  Raymond Lau
  13.                                 100-04 70 Ave.
  14.                         Forest Hills, N. Y. 11375-5133
  15.                                    U. S. A.
  16.  
  17.       Any correspondence, etc... can be electronically mailed to my CIS
  18.                              account, 76174,2617.
  19.  
  20.  
  21.  
  22.                                  Introduction
  23.                                  ------------
  24.  
  25. QuickB Download is a desk accessory written for the CompuServe user who
  26. downloads frequently.  QuickB is a new protocol which allows for significant
  27. speed gains and time savings when downloading from CompuServe.  Currently,
  28. there is only one communications program I know of which supports QuickB.
  29. Many others support regular CIS B, but regular CIS B offers very little
  30. in the way of increased throughput.
  31.  
  32. With QuickB Download DA, you can now utilize the CIS Quick B protocol from
  33. within any communications program.  It has been tested with Red Ryder,
  34. MicroPhone and VersaTerm Pro and it has worked successfully.
  35.  
  36.  
  37.                                  Installation
  38.                                  ------------
  39.  
  40. To install QuickB Download, you should be familar with the operation of
  41. Apple's Font/DA Mover.  If you are not, please consult the appropriate
  42. documentation before continuing.
  43.  
  44. QuickB Download may be installed into the System file, where you can use
  45. it in any communications program, if you use more than one.  It may also
  46. be installed directly into your communications program(s).
  47.  
  48.  
  49.                                   Operation
  50.                                   ---------
  51. Operation is very straight forward.
  52.  
  53. Initiate the QuickB download process on CompuServe.
  54. (If you're browsing a file description, type "d /proto:qb".  Of if you
  55. know the name of the file and want to download from the main data library
  56. menu, type "dow [filename]/proto:qb".  For example, to download Stuffi.Bin
  57. from the DL 8 of MacPro, type dow stuffi.bin/proto:qb")
  58.  
  59. CompuServe will prompt you for a file name.  Type in the primary file name
  60. for text files at this point.  For binary files, enter any name.
  61. (File naming will be explained later)
  62.  
  63. Now, go to the Apple menu and select QuickB Download.
  64.  
  65. You will be presented with the standard "save as" dialog box.  Here, you
  66. can select the destination folder to save the downloaded file.  For the
  67. file name, type in the last choice filename.  (File naming will be
  68. explained shortly!)  Or just press return to use the default.
  69.  
  70. Press return or click save.
  71.  
  72. That's all there is to it!  Now sit back and note the enhanced speed!
  73. Count the dollars you'll be saving off file downloading!
  74.  
  75.    [A small problem.  CIS isn't always too responsive.  If you see
  76.     that the download isn't beginning within a reasonable amount of
  77.     time, abort and try again.  Sometimes CIS is so overloaded that it
  78.     gets confused and goes "out of sync" at the beginning.]
  79.  
  80. (NOTE: When using Red Ryder, you must uncheck the Enable CIS 'B' option.
  81.  If you don't, Red Ryder will take over and CompuServe will think that you
  82.  want to use regular B rather than the extended QuickB with QuickB
  83.  Download.)
  84.  
  85.                                  File Naming
  86.                                  ---- ------
  87.  
  88. QuickB Download uses the following procedure when naming files:
  89.  
  90. For MacBinary Files:
  91. (including applications, DAs, FKEYs, MacWrite files, StuffIt archives,etc.)
  92.  
  93. • The original file name, the one the file was uploaded with, will be used
  94.     first.
  95. • If a file already exists by that name, the last choice file name
  96.     will be used.  This is the file name you typed into the dialog box
  97.     when you selected QuickB Download from the Apple menu.
  98.     (Since you selected this as the ultimate name, if a file already
  99.      exists, it will be deleted and replaced.)
  100.     
  101.     [Note: Previously, I had erroneously documented that the name you
  102.      entered at the File Name: prompt will be used second.  This false
  103.      assumption led to big problems.  It appears that for binary files,
  104.      CIS sends gibberish...]
  105.  
  106. For TEXT and other non-MacBinary files:
  107. • The file name you typed in at the "Filename:" prompt will be used.
  108.     This is why I referred to this as the primary text file name.
  109. • If a file already exists by that name, the last choice file name
  110.     will be used.  This is the file name you typed into the dialog box
  111.     when you selected QuickB Download from the Apple menu.
  112.     (Since you selected this as the ultimate name, if a file already
  113.      exists, it will be deleted and replaced.)
  114.  
  115.  
  116. If this seems unneccessarily confusing, don't worry!  You don't have to
  117. memorize it per se... In most cases, this procedure would be what you
  118. would want intuitively.
  119.  
  120.  
  121.                                    Aborting
  122.                                    --------
  123.  
  124. Hold down the command and period keys until you hear a beep to abort the
  125. download process.  This works MOST of the time.  At times, CompuServe
  126. may not recognize the abort sequence sent by QuickB Download.  If you
  127. think CompuServe is hanging on you after you issued an abort and QuickB
  128. Download has closed itself, type in a sequence of four control-P's.
  129. Wait 3-5 seconds.  Repeat 2-4 times if needed.  Usually, this "Panic
  130. Abort" sequence is recognized if it is sent 3 times.  (It SHOULD be
  131. recognized the first time according to the CompuServe documentation, but
  132. in practice, it usually takes 3 panic abort sequences.)
  133.  
  134.  
  135.                                      Tip
  136.                                      ---
  137.  
  138. Use QuicKeys or FKeyMakerApp make a QuicKey or a FKEY, respectively, 
  139. to invoke QuickB Download from the keyboard.  Hey, when you're paying for
  140. time time you spend online, avoiding the mouse cuts down on that time!
  141.  
  142.  
  143.                                Why No Background?
  144.                                --- -- -----------
  145.  
  146. You may ask why not have QuickB Download work in the background?  The
  147. answer is simple.  If I were to make it work in the background, it would
  148. require you to quick from your communications program before you can run
  149. QuickB Download...  (Such as with BackDown)  This would waste time.
  150. Furthermore, background operation may be stalled while you're doing time
  151. intensive operations in the foreground...wasting more time.  Hey, you're
  152. paying $12.50 an hour!  Do you really want to waste time?
  153.  
  154.  
  155.                                 Other Products
  156.                                 ----- --------
  157.  
  158. If you haven't tried StuffIt, my file compression/archival utility, yet,
  159. give it a try!  It will save you disk space, time,  and ultimately money!
  160.  
  161. I am devoted to bringing time and/or money saving products to the public
  162. as long as I can support my own development time...  So, any suggestions
  163. on other products will be appreciated.
  164.  
  165.  
  166.                                QuickB Protocol
  167.                                ------ --------
  168. (For the technical types and the curios.  With editorial comments.)
  169.  
  170. CompuServe's QuickB protocol is an extension of their CIS B protocol.
  171. The version QuickB Download implements is current as of Jan. '88.
  172. It provides for a maximum packet size of 1024 bytes (1k) to reduce time
  173. spent in error checking.  It allows for a one packet send ahead facility.
  174. (otherwise known as sliding window or windowed.)  It uses XModem style
  175. CRC (bits reversed from CRC-CCITT standard) for error checking and
  176. correction.
  177.  
  178. It has the ability to fall back to smaller sized packets if the host
  179. doesn't support 1k packets.  It can also fall back to no send ahead and
  180. checksum error checking.  These capabilities are meant for communicating
  181. with someone using older versions of CompuServe's Vidtex communications
  182. software on other computers.  There isn't a version for the Mac that I
  183. know of.